home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / ab20 / unarced / datacomm / term1.9c / termrexx.dok < prev    next >
Text File  |  1995-03-17  |  35KB  |  677 lines
  1. ================================== term ===================================
  2. ===========================================================================
  3.               Ein  Gift-Ware  Telekommunikationsprogramm von
  4.          Olaf Barthel, © Copyright 1990,91 by Olaf Barthel & MXM,
  5.                          alle Rechte vorbehalten.
  6.  
  7.    Es   wird   keinerlei   Gewährleistungspflicht   für   die  vollständige
  8. Funktionsfähigkeit  des  (der)  in diesem Dokument beschriebenen Programmes
  9. (Programme) übernommen.  Sie nutzen diese Software auf eigenes Risiko.
  10.  
  11.  
  12. ============================= term und ARexx ==============================
  13. ===========================================================================
  14. In   dieser   Datei  sollen  die  von  `term'  unterstützten  ARexx-Befehle
  15. beschrieben  werden.   Dies ist keine Einführung in die Sprache selbst, die
  16. von  Mike  F.   Cowlishaw auf dem IBM VM/SP® entwickelt (eine Bewertung des
  17. VMS/CMS®  will ich mir hier sparen) und von William S.  Hawes auf dem Amiga
  18. implementiert wurde.
  19.    ARexx  (oder  auch  Amiga  Rexx)  ist ein kommerzielles Produkt, das dem
  20. AmigaDOS 2.0 Enhancer Package beiliegt. Wer nach einer guten Einführung und
  21. Beschreibung   der   Sprache   sucht,   dem  empfehle  ich  das  Buch  `Die
  22. Programmiersprache  REXX'  von  M.   F.  Cowlishaw, erschienen 1988 im Carl
  23. Hanser Verlag München/Wien, ISBN 3-446-15195-8.
  24.  
  25.    `term'  richtet einen Rexx-Host unter dem Namen "TERM" ein (anzusprechen
  26. mittels `address term').  Startet man mehrere `term'-Programme, so wird der
  27. Name  des  Hosts  der  Nummer des Programmes angepaßt (das erste gestartete
  28. Programm meldet den Host unter dem Namen `TERM' an, das zweite bedient sich
  29. `TERM1',  das dritte nimmt `TERM2', etc.).  Der Name wird auch im Titel des
  30. Hauptbildschirmes des jeweiligen Programmes angezeigt.
  31.    Insgesamt  werden genau 44 Befehle unterstützt, die sich in zwei Klassen
  32. einteilen lassen:
  33.  
  34. - Asynchrone  Befehle,  die  `augenblicklich'  ausgeführt  werden  und  ein
  35.   ARexx-Programm nicht zum Warten zwingen.
  36.  
  37. - Synchrone  Befehle,  die  das Hauptprogramm `term' selbst ausführt.  Dies
  38.   kann  es  notwendig machen, daß das ARexx-Programm wartet, bis der Befehl
  39.   ausgeführt wurde.
  40.  
  41.  
  42. ========================= Die Asynchronen Befehle =========================
  43. ===========================================================================
  44. CLEARDISPLAY........... Löscht den Inhalt des `Logbuches'.
  45.  
  46. CLOSEDISPLAY........... Schließt   den  Bildschirm  des  `Logbuches',  läßt
  47.                         dessen Inhalt aber unverändert.
  48.  
  49. DEFAULT2FRONT.......... Schiebt  den  Standardbildschirm (`Default Screen')
  50.                         nach    vorne.     Dies   ist   üblicherweise   der
  51.                         Workbench-Bildschirm.
  52.  
  53. REXX2FRONT............. Schiebt  den  Bildschirm  nach  vorne,  auf dem das
  54.                         Ausgabefenster des ARexx-Interfaces liegt.
  55.  
  56. DISPLAY2FRONT.......... Schiebt den Bildschirm des `Logbuches' nach vorne.
  57.  
  58. TERM2FRONT............. Schiebt  den  Hauptbildschirm des `term' Programmes
  59.                         nach vorne.
  60.  
  61. WB2FRONT............... Schiebt  ausdrücklich den Workbench-Bildschirm nach
  62.                         vorne.
  63.  
  64. CLEARDOWNLOADLIST...... Die  Liste  aller  bisher  empfangenen Dateien wird
  65.                         gelöscht.
  66.  
  67. QUERY.................. Mit   diesem   Befehl   lassen   sich  verschiedene
  68.                         Systemparameter abfragen.  Aufgrund der Komplexität
  69.                         dieses  Befehles  soll  er  nachfolgend beschrieben
  70.                         werden.
  71.  
  72. QUIETEXIT.............. Wird   dieser   Befehl   aufgerufen,  so  wird  das
  73.                         Ausgabefenster   des   Programmes  nach  Beendigung
  74.                         sofort geschlossen.  Üblicherweise bleibt es bis zu
  75.                         einer Bestätigung durch den Anwender geöffnet.
  76.  
  77.  
  78. =========================== Der `QUERY' Befehl ============================
  79. ===========================================================================
  80. Die  folgenden Parameter lassen sich über den `QUERY' Befehl abfragen (z.B.
  81. über `query baudrate'):
  82.  
  83. ADOWNLOADPATH.......... Der   Name  des  Verzeichnisses  in  dem  die  beim
  84.                         Empfangen   von  ASCII-Daten  entstehenden  Dateien
  85.                         abgelegt werden.
  86.  
  87. AUPLOADPATH............ Der  Name  des Verzeichnisses, das beim Verschicken
  88.                         von ASCII-Dateien durchsucht wird.
  89.  
  90. AUDBELL................ ON   wenn   ein   akustisches   Signal   bei  jedem
  91.                         `Bell'-Zeichen ausgegeben wird, sonst OFF.
  92.  
  93. AUTOCAPTURE............ ON    falls   beim   erfolgreichen   Aufbau   einer
  94.                         Telefonverbindung  eine  Mittschnitt-Datei angelegt
  95.                         wird, sonst OFF.
  96.  
  97. BAUDRATE............... Die     aktuell     eingestellte    Übertragungsge-
  98.                         schwindigkeit in Bits/Sekunde.
  99.  
  100. BEEPSOUND.............. Der  Name  der  IFF-Sound-Datei,  die  anstelle des
  101.                         normalen  Piepsens  beim Eingang eines BEL-Signales
  102.                         gespielt wird.
  103.  
  104. BITSPERCHAR............ Die Anzahl der übertragenen Bits pro Zeichen.
  105.  
  106. BLINKING............... ON   falls   die   Blinkfunktionen   des  Terminals
  107.                         eingeschaltet sind, sonst OFF.
  108.  
  109. BREAKLENGTH............ Die    Dauer    eines   Unterbrechungssignales   in
  110.                         Mikrosekunden   (1   Million   Mikrosekunden   =  1
  111.                         Sekunde).
  112.  
  113. BDOWNLOADPATH.......... Der   Name  des  Verzeichnisses  in  dem  die  beim
  114.                         Empfangen   von  Binär-Daten  entstehenden  Dateien
  115.                         abgelegt werden.
  116.  
  117. BUPLOADPATH............ Der  Name  des Verzeichnisses, das beim Verschicken
  118.                         von Binär-Dateien durchsucht wird.
  119.  
  120. BUSY................... Die  Zeichenkette,  an  Hand derer die Wählfunktion
  121.                         erkannt, daß eine Telefonleitung besetzt ist.
  122.  
  123. CAPTUREFILTER.......... ON  wenn  Steuersequenzen  aus der Mittschnittdatei
  124.                         ausgefiltert werden sollen, sonst OFF.
  125.  
  126. CAPTUREPATH............ Das  Verzeichnis,  in  dem die Mittschnitt-Dateien,
  127.                         die bei aktivierter `Connect Auto-Capture'-Funktion
  128.                         entstehen, abgelegt werden.
  129.  
  130. CAPTURESTATE........... Gibt den aktuellen Mitschnitt-Modus aus:  `PRINTER'
  131.                         wenn  auf den Drucker mitprotokolliert wird, `FILE'
  132.                         wenn  in eine Datei mitgeschnitten wird.  Es können
  133.                         auch  beide  Wörter  zurückgeliefert  werden,  oder
  134.                         `OFF' falls der Mitschnitt nicht aktiviert wurde.
  135.  
  136. CHARACTERWRAP.......... ON falls am rechten Bilschirmrand ein Zeilenumbruch
  137.                         durchgeführt wird, sonst OFF.
  138.  
  139. COLOUR................. Dieser   Befehl  liest  die  aktuell  eingestellten
  140.                         Farbinformationen  des `term' Hauptbildschirmes aus
  141.                         (`query  colour  12')  und  liefert  den jeweiligen
  142.                         Farbwert als Hexadezimalzahl zurück (`FFF').
  143.  
  144. COLOURMODE............. Der  aktuell  eingestellte Farbmodus (AMIGA, EIGHT,
  145.                         SIXTEEN, MONO).
  146.  
  147. COLUMNS................ Die Anzahl Zeichen pro Zeile.
  148.  
  149. CONNECT................ Die  Zeichenkette,  an  Hand derer die Wählfunktion
  150.                         erkannt, daß ein Telefonverbindung aufgebaut werden
  151.                         konnte.
  152.  
  153. CONNECTAUTOBAUD........ ON  wenn  beim  Aufbau  einer Telefonverbindung die
  154.                         Übertragungsgeschwindigkeit     automatisch     neu
  155.                         ermittelt wird, sonst OFF.
  156.  
  157. CURSOR................. Liefert  die  aktuelle  Position  der  Schreibmarke
  158.                         zurück.    X-   und   Y-Position   sind  durch  ein
  159.                         Leerzeichen getrennt (`12 23').
  160.  
  161. CURSORMODE............. Arbeitsmodus   der  Cursortasten  (`STANDARD'  oder
  162.                         `APPLICATION').
  163.  
  164. CURSORWRAP............. ON  falls  der  Cursor  in  seinen Bewegungen nicht
  165.                         eingeschränkt ist, sonst OFF.
  166.  
  167. DEFAULTSTORE........... Der   Name   des   Verzeichnisses,   in   dem  alle
  168.                         Konfigurationsdateien   des   Programmes   abgelegt
  169.                         werden.
  170.  
  171. DIALPREFIX............. Die   Befehlssequenz,   die   jeder   zu  wählenden
  172.                         Telefonnummer vorangestellt wird.
  173.  
  174. DIALRETRIES............ Die   maximale  Anzahl  von  Durchläufen,  die  die
  175.                         Wählfunktion  unternimmt,  um eine Telefonverbidung
  176.                         aufzubauen.
  177.  
  178. DIALTIMEOUT............ Die Zeit in Sekunden, die die Wählfunktion nach der
  179.                         Anwahl  einer  Telefonnummer  bis zum erfolgreichen
  180.                         Aufbau einer Verbindung wartet.
  181.  
  182. DISPLAYMODE............ Der   Anzeigemodus   des  `term'  Hauptbildschirmes
  183.                         (HIRES,   HIRESLACE,   SUPERHIRES,  SUPERHIRESLACE,
  184.                         PRODUCT,   PRODUCTLACE,   PALHIRES,   PALHIRESLACE,
  185.                         PALSUPERHIRES,     PALSUPERHIRESLACE,    NTSCHIRES,
  186.                         NTSCHIRESLACE,  NTSCSUPERHIRES, NTSCSUPERHIRESLACE,
  187.                         A2024TENHZ, A2024FIFTEENHZ).
  188.  
  189. DOWNLOADS.............. Die   Anzahl  der  Dateien,  die  bisher  empfangen
  190.                         wurden.
  191.  
  192. DSBACKSPACE............ ON  wenn  das  `Backspace'-Zeichen auch das Zeichen
  193.                         links der Schreibmarke löscht, sonst OFF.
  194.  
  195. DUPLEX................. Datenübertragungsart (FULL, HALF).
  196.  
  197. EDITOR................. Name  des  Text-Editors, der von der Funktion `Edit
  198.                         File' aufgerufen wird.
  199.  
  200. EIGHTYCOLUMNS.......... ON  falls  der  Bildschirm  auf  80  ×  24  Zeichen
  201.                         beschränkt wurde, sonst OFF.
  202.  
  203. EMULATION.............. Die   gerade   aktive   Terminalemulation  (ANSIVT,
  204.                         ATOMIC,TTY).
  205.  
  206. ERROR.................. Die  Zeichenkette,  die  das  Modem  beim Auftreten
  207.                         eines Fehlers sendet.
  208.  
  209. FONT................... Der eingestellte Zeichensatz (TOPAZ, IBM).
  210.  
  211. FONTSCALE.............. Größe   des   Zeichensatzes  (`NORMAL',  `HIGHTOP',
  212.                         `HIGHBOTTOM', `WIDE', `HALF').
  213.  
  214. HANDSHAKING............ Der    eingestellte   Handshaking-Modus   (XONXOFF,
  215.                         RTSCTS, NONE).
  216.  
  217. HIGHSPEED.............. ON   falls   der   `Hochgeschwindigkeitsmodus'  des
  218.                         seriellen Treibers aktiviert wurde, sonst OFF.
  219.  
  220. INSERTMODE............. ON  falls  das  Terminal  im Einfügemodus arbeitet,
  221.                         sonst OFF (Überschreibemodus).
  222.  
  223. LINE................... ON falls eine Telefonverbindung besteht, sonst OFF.
  224.  
  225. LINES.................. Die   Anzahl   Zeilen,   die   auf  dem  Bildschirm
  226.                         darstellbar sind.
  227.  
  228. LOGACTIONS............. ON  falls  alle  Aktionen  des  Programmes in einer
  229.                         Datei mitprotokolliert werden, sonst OFF.
  230.  
  231. LOGFILE................ Der  Name  der  Datei,  in der bei aktivierter `Log
  232.                         Actions'-Funktion alle Aktionen gespeichert werden.
  233.  
  234. MACRO.................. Von    diesem   Befehl   werden   als   zusätzliche
  235.                         Aufrufparameter  Qualifier (None, Shift, Alternate,
  236.                         Control)   und   die   Funktionstastennummer  (0-9)
  237.                         erwartet  (`query  macro none 0').  Es wird die mit
  238.                         der    entsprechenden   Funktionstaste   verknüpfte
  239.                         Befehlssequenz zurückgeliefert.
  240.  
  241. MACROFILE.............. Der      Name     der     aktuell     eingestellten
  242.                         Funktionstastendefinitionsdatei.
  243.  
  244. MODEMEXIT.............. Die   Befehlssequenz,   die   beim   Verlassen  des
  245.                         Programmes an das Modem geschickt wird.
  246.  
  247. MODEMHANGUP............ Die   Befehlssequenz,   die   zum  Abbrechen  einer
  248.                         Verbindung an das Modem geschickt wird.
  249.  
  250. MODEMINIT.............. Die  Befehlssequenz,  die  beim  Programmstart  zur
  251.                         Initialisierung des Modems verschickt wird.
  252.  
  253. NOCARRIER.............. Die  Zeichenfolge, die das Modem beim Abbruch einer
  254.                         Telefonverbindung verschickt.
  255.  
  256. NEWLINEMODE............ ON falls das Terminal im `New Line'-Modus arbeitet,
  257.                         sonst OFF.
  258.  
  259. NUMERICMODE............ Der  Arbeitsmodus  des  Zehnerblockes  (`STANDARD',
  260.                         `APPLICATIONS').
  261.  
  262. OKAY................... Die  Zeichenkette,  die  das  Modem zur Bestätigung
  263.                         eines Befehles abschickt.
  264.  
  265. PARITY................. Der aktuell eingestellte Paritätsmodus (NONE, EVEN,
  266.                         ODD, MARK, SPACE).
  267.  
  268. PROTOCOL............... Das    aktuell    eingestellte    Transferprotokoll
  269.                         (xprzmodem.library, xprxmodem.library, etc.).
  270.  
  271. PROTOCOLOPTIONS........ Die  verwendeten  Optionen des gerade eingestellten
  272.                         Transferprotokolles.   Die  Bedeutung  der Optionen
  273.                         ist der Dokumentation des jeweiligen Protokolles zu
  274.                         entnehmen.
  275.  
  276. PUBLICSCREEN........... ON  wenn  der `term' Hauptbildschirm als öffentlich
  277.                         zugänglicher Bereich geöffnet wurde, sonst OFF.
  278.  
  279. REDIALDELAY............ Die  Zeit  in Minuten, die die Wählfunktion vor dem
  280.                         nächsten Durchlauf der Wählliste wartet.
  281.  
  282. REQUESTERS............. ON   wenn   Sicherheitsabfragen   angezeigt  werden
  283.                         sollen, sonst OFF.
  284.  
  285. RING................... Die Zeichenfolge, die das Modem beim Erkennen eines
  286.                         Anrufes sendet, der von einem anderen Modem stammt.
  287.  
  288. SCREENADDRESS.......... Liefert  die  Adresse  des `term'-Hauptbildschirmes
  289.                         als Dezimalzahl zurück.
  290.  
  291. SENDCR................. Der   Modus,   in   dem   ein   `Carriage   Return'
  292.                         (Zeilenrücklauf)   versandt   wird  (IGNORE,  ASCR,
  293.                         ASCRLF).
  294.  
  295. SENDLF................. Der  Modus, in dem ein `Line Feed' (Zeilenvorschub)
  296.                         versandt wird (IGNORE, ASLF, ASLFCR).
  297.  
  298. SERIAL................. ON  wenn  der  serielle  Treiber noch zur Verfügung
  299.                         steht, wenn er bereits freigegeben wurde OFF.
  300.  
  301. SERIALDEVICE........... Der Name des eingestellten seriellen Treibers.
  302.  
  303. SHANGHAI............... ON  wenn  Fenster  der  Workbench  auf  dem  `term'
  304.                         Hauptbildschirm geöffnet werden sollen, sonst OFF.
  305.  
  306. SMOOTHSCROLL........... ON    falls   der   Bildschirm   viertelzeilenweise
  307.                         gescrollt wird, sonst OFF.
  308.  
  309. SPEECHFILE............. Der Name der aktuellen Sprach-Konfigurationsdatei.
  310.  
  311. SPEECH................. ON  falls der Sprachsynthesizer in `term' aktiviert
  312.                         wurde, sonst OFF.
  313.  
  314. SPEECHRATE............. Die  Sprechgeschwindigkeit,  des Sprachsynthesizers
  315.                         in Worten pro Minute.
  316.  
  317. SPEECHPITCH............ Die Stimmververzerrung des Sprachsynthesizers.
  318.  
  319. SPEECHFREQUENCY........ Die Stimmhöhe des Sprachsynthesizers in Hertz.
  320.  
  321. SPEECHVOLUME........... Die Sprechlautstärke des Sprachsynthesizers.
  322.  
  323. SPEECHSEX.............. Das  Geschlecht  der  Stimme des Sprachsynthesizers
  324.                         (MALE = männlich, FEMALE = weiblich).
  325.  
  326. STARTUP................ Die   Befehlssequenz  die  beim  Start  des  `term'
  327.                         Programmes  ausgeführt  wird  (oder  was die letzte
  328.                         Telefonverbindung in diesem Feld gelassen hat).
  329.  
  330. STATUS................. Der  übergeordnete  Zustand  des  `term' Programmes
  331.                         (READY,   HOLDING,   DIALING,   UPLOAD,   DOWNLOAD,
  332.                         BREAKING, HANGUP).
  333.  
  334. STOPBITS............... Die  Anzahl  der  bei  der  Übertragung verwendeten
  335.                         Stopbits.
  336.  
  337. TIMEOUT................ Die Länge in Mikrosekunden, die beim `INPUT' Befehl
  338.                         vor dem Abbruch gewartet wird.
  339.  
  340. TDOWNLOADPATH.......... Der   Name  des  Verzeichnisses  in  dem  die  beim
  341.                         Empfangen   von   Text-Daten  entstehenden  Dateien
  342.                         abgelegt werden.
  343.  
  344. TUPLOADPATH............ Der  Name  des Verzeichnisses, das beim Verschicken
  345.                         von Text-Dateien durchsucht wird.
  346.  
  347. UNITNUMBER............. Die  Nummer  des  seriellen Treibers der eigestellt
  348.                         wurde.
  349.  
  350. VISBELL................ ON    wenn   ein   optisches   Signal   bei   jedem
  351.                         `Bell'-Zeichen ausgegeben wird, sonst OFF.
  352.  
  353. VOICE.................. Die Zeichenfolge, die das Modem überträgt, wenn ein
  354.                         Anruf  erkannt  wird,  der  nicht von einem anderen
  355.                         Modem stammt.
  356.  
  357.  
  358. ========================= Die Synchronen Befehle ==========================
  359. ===========================================================================
  360. BDOWNLOAD.............. Führt   einen  Datentransfer  zum  `term'  Programm
  361.                         durch.    Ein  Dateiname  wird  erwartet,  muß  bei
  362.                         Protokollen wie ZModem aber nicht vorhanden sein.
  363.  
  364. BEEP................... Läßt  den  Bildschirm  blitzen/piepen, etc.  in der
  365.                         Manier des `Bell'-Zeichens.
  366.  
  367. BREAK.................. Schickt    ein    Unterbrechungssignal   über   die
  368.                         Telefonleitung.
  369.  
  370. BUFFER................. Befaßt   sich   mit  dem  Inhalt  des  `Logbuches'.
  371.                         Mittels  `buffer  new  file'  wird  der  Inhalt des
  372.                         `Logbuches'   mit   dem  Inhalt  der  Datei  `file'
  373.                         überschrieben,  `set  buffer  append file' fügt den
  374.                         Inhalt  der  Datei  an das bestehende `Logbuch' an.
  375.                         Wird  `buffer  display'  aufgerufen,  so  wird  der
  376.                         Bildschirm des `Logbuches' geöffnet.
  377.  
  378. BUPLOAD................ Schickt eine Datei an den Empfänger auf der anderen
  379.                         Seite  der  Telefonleitung.  Hier muß ein Dateiname
  380.                         angegeben    werden,    oder    das    eingestellte
  381.                         Transferprotokoll  wird  sich  beklagen.   Nur  ein
  382.                         Dateiname  wird  akzeptiert,  wer  mehrere  Dateien
  383.                         wünscht, sollte sich mit Wildcardmustern befassen.
  384.  
  385. CAPTURE................ Ändert  den  Zustand des Mitschnittes auf Diskette.
  386.                         Mitels   `capture   close'  wird  das  Mitschneiden
  387.                         abgebrochen,  `capture  new file' überschreibt eine
  388.                         Zieldatei  mit  dem  Mittschnitt,  `capture  append
  389.                         file' fügt den Mitschnitt an eine Datei an.
  390.  
  391. CLEARSCREEN............ Löscht schlicht und einfach den Bildschirm.
  392.  
  393. COMMAND................ Schickt  eine  Befehlssequenz  in der Art und Weise
  394.                         des   `term'   Hauptprogrammes  über  die  serielle
  395.                         Leitung.
  396.  
  397. CONFIG................. Speichert  die  aktuelle  Konfiguration ab (`config
  398.                         save  file')  oder  lädt und setzt sie neu (`config
  399.                         load file').
  400.  
  401. DELAY.................. Wartet  eine  anzugebende Zeitperiode.  Dieser Wert
  402.                         sollte   nicht   zu  groß  bemessen  sein,  da  die
  403.                         Wartezeit  nicht  abgekürzt  werden  kann.  Es kann
  404.                         jeweils    in   Mikrosekunden-,   Sekunden-,   oder
  405.                         Minutenintervallen gewartet werden:
  406.  
  407.                            delay 10 mic -> Wartet zehn Mikrosekunden.
  408.                            delay 10 sec -> Wartet zehn Sekunden.
  409.                            delay 10 min -> Wartet zehn Minuten.
  410.  
  411. DIAL................... Wählt  eine  Telefonnummer, wer Spaß daran hat, der
  412.                         kann  auch den Namen eines Eintrages im Telefonbuch
  413.                         angeben.   Wird  der  Eintrag gefunden, so wird die
  414.                         damit verknüpfte Telefonnummer verwendet.  Ein Wort
  415.                         der Warnung:  der Wählbefehl wird abgeschickt, eine
  416.                         Verarbeitung  des Ergebnisses muß anders gehandhabt
  417.                         werden.
  418.  
  419. FILEREQUEST............ Zeigt ein Datei-Auswahlfeld an, der übergebene Text
  420.                         wird   im   Titelbalken   des  jeweiligen  Fensters
  421.                         angezeigt.   Diese  Funktion  liefert den Namen von
  422.                         Datei  und  Verzeichnisses zurück, die der Benutzer
  423.                         ausgewählt hat.
  424.  
  425. FIRSTDOWNLOAD.......... Die Namen aller empfangenen Dateien werden in einer
  426.                         Liste gespeichert, die sich vom ARexx-Interface aus
  427.                         auslesen  läßt.   Dieser  Befehl liefert den ersten
  428.                         Namen in dieser Liste zurück.
  429.  
  430. GETCLIP................ Entnimmt  den  Inhalt  des `Clipboards' und liefert
  431.                         ihn als Zeichenkette zurück.
  432.  
  433. GETSTRING.............. Fordert  eine  Zeichenkette vom Anwender des `term'
  434.                         Programmes an.
  435.  
  436. HANGUP................. Bricht  die Telefonverbindung, die gerade aktiv ist
  437.                         (sofern  überhaupt  vorhanden)  kurz und schmerzlos
  438.                         ab, indem das Modem zum Auflegen gebracht wird.
  439.  
  440. INPUT.................. Liest  eine  anzugebende Anzahl von Zeichen von der
  441.                         seriellen  Leitung.   Wurde  ein  `TIMEOUT' mit dem
  442.                         entsprechenden  Kommando  gesetzt,  wird  nach  dem
  443.                         Eintreffen  von  genügend  Zeichen  oder  nach  dem
  444.                         Verstreichen der Wartezeit zurückgekehrt.
  445.  
  446. LASTDOWNLOAD........... Die Namen aller empfangenen Dateien werden in einer
  447.                         Liste gespeichert, die sich vom ARexx-Interface aus
  448.                         auslesen  läßt.   Dieser Befehl liefert den letzten
  449.                         Namen in dieser Liste zurück.
  450.  
  451. MACROS................. Speichert  die  aktuelle Funktionstastenbelegung ab
  452.                         (`macros  save  file')  oder lädt und setzt sie neu
  453.                         (`macros load file').
  454.  
  455. MESSAGE................ Gibt  einen  Text  auf dem Bildschirm aus (der Text
  456.                         wird nicht über die serielle Leitung verschickt).
  457.  
  458. NEXTDOWNLOAD........... Die Namen aller empfangenen Dateien werden in einer
  459.                         Liste gespeichert, die sich vom ARexx-Interface aus
  460.                         auslesen  läßt.  Dieser Befehl liefert den nächsten
  461.                         Namen   in  dieser  Liste  zurück,  es  muß  vorher
  462.                         entweder    `firstdownload'   oder   `lastdownload'
  463.                         aufgerufen  worden  sein, um einen Ausgangspunkt in
  464.                         der Liste bestimmen zu können.
  465.  
  466. PHONE.................. Speichert  das aktuelle Telefonbuch ab (`phone save
  467.                         file')  oder  lädt  und  setzt  es neu (`phone load
  468.                         file').
  469.  
  470. PRINTER................ Schaltet  die Protokollierung der eingehenden Daten
  471.                         auf  dem Druck ab (`printer off') oder zu (`printer
  472.                         on').
  473.  
  474. PUTCLIP................ Legt eine Zeichenkette im `Clipboard' ab.
  475.  
  476. RESETSTYLES............ Führt die Terminalemulation wieder auf den Pfad der
  477.                         Tugend   zurück   (alle   Zeichenattribute   werden
  478.                         zurückgesetzt).
  479.  
  480. SAVEILBM............... Speichert   den   Inhalt   des   Bildschirmes   als
  481.                         IFF-ILBM-Datei  unter einem anzugebenden Dateinamen
  482.                         ab.
  483.  
  484. SET.................... Setzt    Systemparameter    neu,    eine   genauere
  485.                         Beschreibung folgt diesem Text.
  486.  
  487. SIMPLEREQUEST.......... Stellt  einen Text in einem Hinweisfeld (wie `term'
  488.                         es  z.B.  beim Verlassen des Programmes zeigt) dar.
  489.                         Der  Bildschirm  von `term' wird automatisch in den
  490.                         Vordergrund gebracht.
  491.  
  492. SPEAK.................. Spricht  -  sofern  möglich  -  einen Text über den
  493.                         Sprachsynthesizer des Amiga aus.
  494.  
  495. SPEECH................. Speichert    die    aktuellen   Einstellungen   des
  496.                         Sprachsynthesizers  ab  (`speech  save  file') oder
  497.                         lädt und setzt sie neu (`speech load file').
  498.  
  499. TDOWNLOAD.............. Fordert eine Datei (à la BDOWNLOAD) von der anderen
  500.                         Seite   der  Leitung  an,  versucht  dies  aber  im
  501.                         Textmodus.
  502.  
  503. TUPLOAD................ Schickt  eine Datei (à la BUPLOAD) zum anderen Ende
  504.                         der  Leitung,  unternimmt  diesen  wackeren Versuch
  505.                         allerdings im Textmodus.
  506.  
  507. TONEDIAL............... Spielt eine Telefonnummer in Ton-Codierung über die
  508.                         Audio  Hardware  des Amiga ab.  Die Töne können zur
  509.                         Anwahl   einer   Telefonnummer   verwendet  werden,
  510.                         vorausgesetzt  das  jeweilige  Telefon  ist an eine
  511.                         digitale   Vermittlungsstelle  der   Telekom  ange-
  512.                         schlossen   und   die  Sprechmuschel  wird  an  den
  513.                         Ausgabelautsprecher gehalten.
  514.  
  515. TWOGADREQUEST.......... Stellt  einen Text in einem Hinweisfeld (wie `term'
  516.                         es  z.B.  beim Verlassen des Programmes zeigt) dar.
  517.                         Der  Bildschirm  von `term' wird automatisch in den
  518.                         Vordergrund gebracht.  Unter dem Hinweisfeld werden
  519.                         zwei   Knöpfe   `Yes'  und  `No'  angezeigt,  diese
  520.                         Funktion   liefert   anschließend  zurück,  welchen
  521.                         dieser beiden Knöpfe der Benutzer angeklickt hat.
  522.  
  523. WAITSTRING............. Wartet  darauf, daß eine bestimmte Zeichenkette vom
  524.                         das  Modem  übertragen  wird.   Es können praktisch
  525.                         unbegrenzt  viele  Zeichenketten  übergeben werden,
  526.                         auf   die  gewartet  werden  soll.   Ist  eine  der
  527.                         Zeichenketten eingegangen, so wird sie als Ergebnis
  528.                         zurückgeliefert.   Groß- und Kleinschreibung werden
  529.                         beim  Überprüfen  ignoriert.   Auch  hier  ist  der
  530.                         globale  Timeout  aktiv  (läßt  sich z.B.  mit `set
  531.                         timeout  10  sec' setzen), verstreicht entsprechend
  532.                         viel Zeit, so kehrt die Routine automatisch zurück.
  533.                         Ich  empfehle  _jedermann_ einen Timeout zu setzen,
  534.                         da  sonst anderenfalls die Möglichkeit besteht, daß
  535.                         die Routine _niemals_ zurückkehrt.
  536.  
  537.                                Beispielaufruf: waitstring "logon: "
  538.  
  539. WRITE.................. Schickt  eine  Zeichenkette über die Leitung, zeigt
  540.                         dies  aber  nicht  notwendigerweise  auf dem `term'
  541.                         Hauptbildschirm an.
  542.  
  543.  
  544. ============================ Der `SET'-Befehl =============================
  545. ===========================================================================
  546. Grundsätzlich  stellt  der  `SET'-Befehl die Umkehrung des `QUERY'-Befehles
  547. dar.   Zu  jedem  Parameter  existiert  ein  analoger Befehl, der dieselben
  548. Eingaben  verarbeitet,  wie  sie  der  `QUERY' Befehl zurückliefert (`query
  549. baudrate'  liefert  z.B.   2400, also läßt sich mit `set baudrate 2400' die
  550. Baudrate entsprechend setzen).
  551.    Da  den  Autor  dieser  Zeilen momentan Rückschmerzen planen und er sich
  552. nach   einem   Non-Stop-Tour-De-Force-Programmierungsmarathon  nicht  allzu
  553. phantastisch  fühlt,  sei  ihm (also mir) erlaubt, an dieser Stelle nur die
  554. Unterschiede zwischen den Befehlen anzugeben:
  555.  
  556. BELL................... Setzt  die Parameter des Bildschirmblitzes neu (die
  557.                         Reaktion  auf das `Bell'-Zeichen).  Hier werden die
  558.                         Aufrufparameter `AUDIBLE' und `VISIBLE' erkannt.
  559.  
  560. COLOUR................. Setzt eine der Bildschirmfarben neu.  Hier wird die
  561.                         Nummer  der  Farbe erwartet (0-15) und der Wert der
  562.                         Farbe als Hexadezimalzahl.
  563.  
  564. MACRO.................. Setzt  eine  der über Funktionstasten aufzurufenden
  565.                         Befehlssequenzen  neu.   Hier  wird  der  Name  des
  566.                         Qualifiers  (None,  Shift,  Alternate, Control) die
  567.                         Nummer  der  Funktionstaste  (0-9)  und die Sequenz
  568.                         erwartet.
  569.                         
  570.                            Beispiel: set macro none 0 hello!
  571.  
  572. SCREEN................. Dies  ist  eine  Kombination  der durch die Befehle
  573.                         `QUERY    PUBLICSCREEN'    und   `QUERY   SHANGHAI'
  574.                         abzufragenden  Optionen.   Als Parameter können der
  575.                         Funktion SHANGHAI und PUBLIC übergeben werden.
  576.  
  577. TIMEOUT................ Setzt  den globalen Timeout, d.h.  die Zeitperiode,
  578.                         die   alle   Lesefunktionen   warten,   bevor   sie
  579.                         automatisch  abgebrochen  werden.   Diese Zeit kann
  580.                         wie  beim  DELAY-Befehl  in Mikrosekunden, Sekunden
  581.                         und Minuten angegeben werden.
  582.  
  583.                                 Beispielaufruf: set timeout 10 sec
  584.  
  585.  
  586.    Hinweis:   zu  den Befehlen `query line', `query lines' `query columns',
  587. `query  status',  `query  cursor',  `query downloads' und `query beepsound'
  588. gibt  es  jeweils kein Gegenstück.  Der Zustand der Telefonverbindung sowie
  589. auch  die  physikalische  Bildschirmgröße kann nicht erzwungen werden.  Zur
  590. Positionierung  der  Schreibmarke  sollte  besser  eine  Steuersequenz  zum
  591. Terminal  geschickt  werden,  als  an  den  internen  Programmvariablen  zu
  592. manipulieren.
  593.  
  594.  
  595. ================================ Probleme =================================
  596. ===========================================================================
  597. Bei  der  Arbeit  mit  dem ARexx-Interface können Probleme auftreten, deren
  598. Klärungen  sich  sich  dem  `normalen' Anwender entziehen.  Ich möchte hier
  599. eine Handvoll potentieller Fragen beanworten:
  600.  
  601. Frage:   Was sind synchrone und was sind asynchrone Befehle und warum mußte
  602.          der Befehlssatz in diese zwei Gruppen getrennt werden?
  603.  
  604. Antwort: Synchrone   Befehle   und   asynchrone  Befehle  werden  von  zwei
  605.          verschiedenen  Instanzen  des  `term'-Programmsystems  ausgeführt.
  606.          Asynchrone  Befehle werden direkt vom selben Prozess abgearbeitet,
  607.          der  die  ARexx-Nachrichten  empfängt.  Synchrone Befehle hingegen
  608.          werden   an   das   `term'-Hauptprogramm  weitergeleitet,  da  die
  609.          entsprechenden Befehle Resourcen benötigen oder verändern, auf die
  610.          nur das Hauptprogramm Zugriff hat.
  611.  
  612.  
  613. Frage:   Mein  ARexx-Programm  scheint plötzlich nicht mehr weiterzulaufen,
  614.          nachdem es eine  der  `term'-Funktionen  angewählt  hat.  Was  ist
  615.          passiert?
  616.  
  617. Antwort: Wahrscheinlich  wurde  ein  synchroner Befehl des ARexx-Interfaces
  618.          aufgerufen  und  das  `term'-Hauptprogramm  ist nicht in der Lage,
  619.          diesen  sofort  zu bearbeiten (ein Datei-Auswahlfeld ist offen, es
  620.          wird  ein  Dateitransfer  über den seriellen Treiber durchgeführt,
  621.          die Funktion `Iconify' wurde aufgerufen).
  622.  
  623.  
  624. Frage:   Warum   kann   man   das   Hauptprogramm  `term'  nicht  über  das
  625.          ARexx-Interface  beenden  oder  über  die  `Iconify'-Funktion  `in
  626.          Schlaf versetzen'?
  627.  
  628. Antwort: Beide   Funktionen  haben  zur  Folge,  daß  die  Abarbeitung  der
  629.          eingehenden  ARexx-Befehle  abgebrochen,  bzw.  unterbrochen wird.
  630.          Nachfolgende  Befehle  würden  nicht  mehr  abgearbeitet  und  das
  631.          ARexx-Programm   nicht   mehr   weiterlaufen:    es   würde  keine
  632.          Unterbrechung  des ARexx-Programmes erfolgen, es würde schlichtweg
  633.          stehenbleiben und sich nicht mehr verlassen lassen.
  634.  
  635.  
  636. ================== Bitte des Autors & Gift-Ware-Gebühr ====================
  637. ===========================================================================
  638. Die  Entwicklung von `term' war mit hohem Aufwand verbunden.  Schon alleine
  639. die     Anstrengungen,     die     zu     unternehmen    waren,    um    im
  640. Trial-And-Error-Verfahren und unter Zuhilfenahme der DevCon-Disketten sowie
  641. Includes  &  Autodocs  die Funktionsweise bestimmter Routinen zu ermitteln,
  642. wäre  es  Wert,  dem  Autor  eine  Entschädigung für seine Mühe zukommen zu
  643. lassen  (es  ist  eben  Pech,  wenn  die Atlanta-DevCon-Unterlagen erst mit
  644. reichlicher Verspätung eintrudeln).
  645.    Der  Autor ist sehr empfänglich für alle Arten von materiellen Gaben und
  646. Geschenken,  solange  gesichert  ist, daß er sie auch verwenden kann (diese
  647. niedlichen  Säcke  mit  Elefantenfutter  schickt  man  doch  besser  an den
  648. hannoverschen  Zoo).   Deshalb  möchte  ich  jedermann  bitten,  dem `term'
  649. gefällt    oder   der   den   Quellcode   bearbeitet,   mich   für   meinen
  650. Programmieraufwand  so  zu  entschädigen,  wie  er/sie denkt, daß es meinen
  651. Anstrengungen  entspricht (wer noch keine Idee hat:  ich suche nach dem GNU
  652. C++  objective `C' compiler in einer auf dem Amiga lauffähigen Version, dem
  653. Quellcode  für  einen Modula-2 Compiler oder LhArc.  Wer mir eine besondere
  654. Freude  machen  möchte, der kann mir ein älteres Infofom-Adventure schenken
  655. --  ausgenommen  `Zork  Zero',  `Journey',  `Hollywood Hijinx' und `Lurking
  656. Horror', die ich selber besitze) - vielen Dank!
  657.  
  658.                              Meine Anschrift:
  659.  
  660.                         Olaf Barthel, MXM (ETG030)
  661.                              Brabeckstrasse 35
  662.                             D-3000 Hannover 71
  663.  
  664.                         Bundesrepublik Deutschland
  665.  
  666.                     Z-Net: O.BARTHEL@A-Link-H
  667.                    Usenet: o.barthel@a-link-h.zer.sub.org
  668.                            cbmvax.commodore.com!cbmehq!sourcery!olsen
  669.  
  670.    Wer  sich  den  Quellcode  ansieht,  um  hier  und  da  Änderungen  oder
  671. Erweiterungen  zu  machen,  der nehme doch vor einer Veröffentlichung bitte
  672. Kontakt   mit   mir   auf,   sodaß  ich  unsere  gemeinsamen  Anstrengungen
  673. koordinieren kann.
  674.    Sollte  jemandem  eine  brilliante  Idee  kommen, den Aufbau oder Inhalt
  675. dieser  Anleitung  zu  verbessern  oder zu erweitern, so möge sie/er es mit
  676. meinem  hiermit  erteilten  Segen tun.
  677.